Yayınlanma tarihi: 13 Kasım 2024, Son güncelleme tarihi: 20 Mayıs 2025
Açıklayıcı | Web | Uzantılar | Chrome Durumu | Amaç |
---|---|---|---|---|
MDN | Görünüm | Deneme yapma niyeti |
Tarayıcıda sağlanan yapay zeka modelleriyle metni çevirmek için Chrome'da Translator API'yi kullanın.
Web siteniz, dünya genelindeki kitlelere erişilebilir olması için web sitesi içeriğini zaten birden fazla dilde sunuyor olabilir. Kullanıcılar, Translator API ile kendi ana dillerinde katkıda bulunabilir. Örneğin, kullanıcılar destek sohbetlerine kendi ana dillerinde katılabilir ve siteniz, kullanıcının cihazından çıkmadan önce bu sohbeti destek temsilcilerinizin kullandığı dile çevirebilir. Bu sayede tüm kullanıcılar sorunsuz, hızlı ve kapsayıcı bir deneyimden yararlanabilir.
Web'deki içeriğin çevrilmesi için genellikle bir bulut hizmetinin kullanılması gerekir. Öncelikle kaynak içerik, çeviriyi hedef dile çalıştıran bir sunucuya yüklenir. Ardından, ortaya çıkan metin indirilir ve kullanıcıya döndürülür. Çeviriyi istemcide çalıştırarak sunucu gezilerinin gerektirdiği zamandan ve çeviri hizmetinin barındırma maliyetinden tasarruf edersiniz.
Başlayın
Translator API, Chrome 138 kararlı sürümünden itibaren kullanılabilir. Öncelikle, tarayıcının Çevirmen API'yi destekleyip desteklemediğini görmek için özellik algılama işlemini çalıştırın.
if ('Translator' in self) {
// The Translator API is supported.
}
Çevirilerin hedef dilini her zaman bilseniz de kaynak dili her zaman bilmeyebilirsiniz. Bu gibi durumlarda Language Detector API'yi kullanabilirsiniz.
Donanım gereksinimlerini inceleyin
Dil Tanımlayıcı ve Çevirmen API'leri, masaüstünde yalnızca Chrome'da çalışır.
Prompt API, Summarizer API, Writer API ve Rewriter API, aşağıdaki koşullar karşılandığında Chrome'da çalışır:
- İşletim sistemi: Windows 10 veya 11; macOS 13 veya üzeri (Ventura ve sonraki sürümler) ya da Linux. Android, iOS ve ChromeOS için Chrome, Gemini Nano tarafından desteklenen API'lerimiz tarafından henüz desteklenmiyor.
- Depolama alanı: Chrome profilinizi içeren birimde en az 22 GB.
- GPU: 4 GB'tan fazla VRAM
- Ağ: Sınırsız veri veya sınırsız bağlantı.
Bu şartlar, geliştirme süreciniz ve oluşturduğunuz özellikleri kullanan kullanıcılarınız için geçerlidir.
Dil çifti desteğini kontrol etme
Çeviri, isteğe bağlı olarak indirilen dil paketleriyle yönetilir. Dil paketi, belirli bir dil için sözlük gibidir.
sourceLanguage
: Metnin geçerli dili.targetLanguage
: Metnin çevrilmesi gereken nihai dil.
BCP 47 dil kısa kodlarını dize olarak kullanın. Örneğin, İspanyolca için 'es'
veya Fransızca için 'fr'
.
const translatorCapabilities = await Translator.availability({
sourceLanguage: 'es',
targetLanguage: 'fr',
});
// 'available'
availability()
işlevi aşağıdaki değerleri içeren bir promise döndürür:
"unavailable"
: Uygulama, belirtilen dillerin çevrilmesini veya dil algılamasını desteklemiyor."downloadable"
: Uygulama, belirtilen dillerin çevrilmesini veya dil algılamasını destekler ancak devam etmek için indirme işlemi gerekir. İndirilen dosya, tarayıcı modeli olabilir."downloading"
: Uygulama, belirli dillerin çevirisini veya dil algılamasını destekler. Tarayıcı, ilişkili nesneyi oluşturma kapsamında devam eden bir indirme işlemini tamamlıyor."available"
: Uygulama, belirtilen dillerin çevrilmesini veya dil algılamasını destekler ve gerekli indirmeler zaten tamamlanmıştır.
downloadprogress
etkinliğiyle model indirme ilerleme durumunu dinleyin:
const translator = await Translator.create({
sourceLanguage: 'es',
targetLanguage: 'fr',
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded * 100}%`);
});
},
});
İndirme başarısız olursa downloadprogress
etkinlikleri durur ve ready
vaadi reddedilir.
Çevirmeni oluşturma ve çalıştırma
Çevirmen oluşturmak için create()
işlevini arayabilirsiniz. Biri sourceLanguage
, diğeri targetLanguage
için olmak üzere iki alanı olan bir seçenekler parametresi gerektirir.
// Create a translator that translates from English to French.
const translator = await Translator.create({
sourceLanguage: 'en',
targetLanguage: 'fr',
});
Çevirmen bulduktan sonra translate()
arayabilirsiniz.
await translator.translate('Where is the next bus stop, please?');
// "Où est le prochain arrêt de bus, s'il vous plaît ?"
Sıralı çeviriler
Çeviriler sırayla işlenir. Çevrilecek çok fazla metin gönderirseniz önceki çeviriler tamamlanana kadar sonraki çeviriler engellenir.
İsteklere en iyi yanıtı vermek için bunları gruplandırın ve çevirinin devam ettiğini belirtmek için döner simge gibi bir yükleme arayüzü ekleyin.
Demo
Language Detector API ile birlikte kullanılan Translator API'yi Translator ve Language Detector API oyun alanında görebilirsiniz.
Standartlaştırma çalışması
Tarayıcılar arası uyumluluğu sağlamak için Translator API'yi standartlaştırmaya çalışıyoruz.
API önerimiz topluluktan destek aldı ve daha fazla tartışma için W3C Web Incubator Topluluğu'na taşındı. Chrome ekibi, W3C Teknik Mimari Grubu'ndan geri bildirim istedi ve Mozilla ile WebKit'ten standartlarla ilgili görüşlerini sordu.
Web Incubator Topluluk Grubu'na katılarak standartlar çalışmalarına katılabilirsiniz.
Geri bildirim
Language Detector API ile neler oluşturduğunuzu görmek isteriz. Web sitelerinizi ve web uygulamalarınızı X, YouTube ve LinkedIn'de bizimle paylaşın.
Chrome'un uygulanmasıyla ilgili geri bildirim için hata raporu veya özellik isteği gönderin.